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About Reference Pages 



The ULTRIX Reference Pages describe commands, system calls, routines, file 
formats, and special files for RISC and VAX platforms. 

Sections 

The reference pages are divided into eight sections according to topic. Within each 
section, the reference pages are organized alphabetically by title, except Section 3, 
which is divided into subsections. Each section and most subsections have an 
introductory reference page called intro that describes the organization and 
anything unique to that section. 

Some reference pages carry a one- to three-letter suffix after the section number, for 
example, scan(lmh). The suffix indicates that there is a "family" of reference 
pages for that utility or feature. The Section 3 subsections all use suffixes and other 
sections may also have suffixes. 

Following are the sections that make up the ULTRIX Reference Pages. 

Section 1 : Commands 

This section describes commands that are available to all ULTRIX users. Section 1 is 
split between two binders. The first binder contains reference pages for titles that fall 
between A and L. The second binder contains reference pages for titles that fall 
between M and Z. 

Section 2: System Calls 

This section defines system calls (entries into the ULTRIX kernel) that are used by 
all programmers. The introduction to Section 2, intro(2), lists error numbers with 
brief descriptions of their meanings. The introduction also defines many of the terms 
used in this section. 

Section 3: Routines 

This section describes the routines available in ULTRIX libraries. Routines are 
sometimes referred to as subroutines or functions. 

Section 4: Special Files 

This section describes special files, related device driver functions, databases, and 
network support. 



Section 5: File Formats 



This section describes the format of system files and how the files are used. The files 
described include assembler and link editor output, system accounting, and file 
system formats. 

Section 6: Games 

The reference pages in this section describe the games that are available in the 
unsupported software subset. The reference pages for games are in the document 
Reference Pages for Unsupported Software. 

Section 7: Macro Packages and Conventions 

This section contains miscellaneous information, including ASCII character codes, 
mail addressing formats, text formatting macros, and a description of the root file 
system. 

Section 8: Maintenance 

This section describes commands for system operation and maintenance. 

Platform Labels 

The ULTRIX Reference Pages contain entries for both RISC and VAX platforms. 
Pages that have no platform label beside the title apply to both platforms. Reference 
pages that apply only to RISC platforms have a "RISC" label beside the title and the 
VAX-only reference pages that apply only to VAX platforms are likewise labeled 
with "VAX." If each platform has the same command, system call, routine, file 
format, or special file, but functions differently on the different platforms, both 
reference pages are included, with the RISC page first. 

Reference Page Format 

Each reference page follows the same general format. Common to all reference pages 
is a title consisting of the name of a command or a descriptive title, followed by a 
section number; for example, date(l). This title is used throughout the 
documentation set. 

The headings in each reference page provide specific information. The standard 
headings are: 

Name Provides the name of the entry and gives a short description. 

Syntax Describes the command syntax or the routine definition. Section 5 

reference pages do not use the Syntax heading. 

Description Provides a detailed description of the entry's features, usage, and 

syntax variations. 

Options Describes the command-line options. 

Restrictions Describes limitations or restrictions on the use of a command or 

routine. 

Examples Provides examples of how a command or routine is used. 
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Return Values 

Diagnostics 
Files 

Environment 



See Also 



Describes the values returned by a system call or routine. Used in 
Sections 2 and 3 only. 

Describes diagnostic and error messages that can appear. 

Lists related files that are either a part of the command or used 
during execution. 

Describes the operation of the system call or routine when 
compiled in the POSIX and SYSTEM V environments. If the 
environment has no effect on the operation, this heading is not 
used. Used in Sections 2 and 3 only. 

Lists related reference pages and documents in the ULTRIX 
documentation set. 



Conventions 

The following documentation conventions are used in the reference pages. 

% The default user prompt is your system name followed by a right 

angle bracket. In this manual, a percent sign ( % ) is used to 
represent this prompt. 

# A number sign is the default superuser prompt. 

user input This bold typeface is used in interactive examples to indicate 
typed user input. 

system output This typeface is used in text to indicate the exact name of a 

command, routine, partition, pathname, directory, or file. This 
typeface is also used in interactive examples to indicate system 
output and in code examples and other screen displays. 



UPPERCASE 

lowercase 



rlogin 



filename 

[ ] 
(I) 



The ULTRIX system differentiates between lowercase and 
uppercase characters. Literal strings that appear in text, 
examples, syntax descriptions, and function definitions must be 
typed exactly as shown. 

This typeface is used for command names in the Syntax portion 
of the reference page to indicate that the command is entered 
exactly as shown. Options for commands are shown in bold 
wherever they appear. 

In examples, syntax descriptions, and routine definitions, italics 
are used to indicate variable values. In text, italics are used to 
give references to other documents. 

In syntax descriptions and routine definitions, brackets indicate 
items that are optional. 

In syntax descriptions and routine definitions, braces enclose lists 
from which one item must be chosen. Vertical bars are used to 
separate items. 



About Reference Pages v 



In syntax descriptions and routine definitions, a horizontal ellipsis 
indicates that the preceding item can be repeated one or more 
times. 

A vertical ellipsis indicates that a portion of an example that 
would normally be present is not shown. 



cat(l) Cross-references to the ULTRIX Reference Pages include the 

appropriate section number in parentheses. For example, a 
reference to cat(l) indicates that you can find the material on the 
cat command in Section 1 of the reference pages. 

Online Reference Pages 

The ULTRIX reference pages are available online if installed by your system 
administrator. The man command is used to display the reference pages as follows: 

To display the ls(l) reference page: 

% man Is 

To display the passwd(l) reference page: 

% man passwd 

To display the passwd(5) reference page: 

% man 5 passwd 

To display the Name lines of all reference pages that contain the word "passwd": 

% man -k passwd 

To display the introductory reference page for the family of 3xti reference pages: 
% man 3xti intro 

Users on ULTRIX workstations can display the reference pages using the 
unsupported xman utility if installed. See the xman(lX) reference page for details. 

Reference Pages for Unsupported Software 

The reference pages for the optionally installed, unsupported ULTRIX software are in 
the document Reference Pages for Unsupported Software. 



vi About Reference Pages 



intro(7) 
Name 

intro - miscellaneous useful information pages 

Description 

This section contains miscellaneous documentation, mostly in the area of text 
processing macro packages for nrof f and other *rof f formatters. 
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ascii(7) 



Name 



ascii - map of ASCII character set 



Syntax 



cat /usr/pub/ascii 



Description 



The ascii file is a map of the ASCII character set, to be printed as needed. It 
contains: 



1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1 100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 



nul 

bs 

die 

can 

sp 

( 

8 

@ 
H 
P 
X 

h 
P 



I 00 nul 

I 08 bs 

I 10 die 

I 18 can 

I 20 sp 
I 28 ( 
I 30 
I 38 8 

I 40 @ 

I 48 H 

I 50 P 

I 58 X 
I 60 v 

I 68 h 

I 70 p 

I 78 x 



001 
011 
021 
031 
041 
051 
061 
071 
101 
111 
121 
131 
141 
151 
161 
171 



soh 
ht 
del 
em 

! 

) 
1 
9 
A 

I 

Q 

Y 

a 
i 

q 
y 



01 soh 
09 ht 
11 del 
19 em 



21 
29 
31 
39 
41 
49 
51 
59 
61 
69 
71 
79 



i 

) 
1 
9 
A 
I 

Q 

Y 

a 
i 

q 

y 



002 
012 
022 
032 
042 
052 
062 
072 
102 
112 
122 
132 
142 
152 
162 
172 



stx 
nl 
dc2 
sub 

tr 
* 

2 

B 
J 
R 
Z 

b 

J 

r 

z 



02 stx 
0a nl 
12 dc2 
la sub 
22 " 
2a * 
32 2 
3a : 
42 B 
4a J 
52 R 
5a Z 
62 b 
6a j 
r 
z 



72 
7a 



003 
013 
023 
033 
043 
053 
063 
073 
103 
113 
123 
133 
143 
153 
163 
173 



etx 
vt 
dc3 
esc 

# 

+ 
3 

» 

C 
K 
S 

[ 
c 

k 
s 

{ 



03 etx 
0b vt 

13 dc3 
lb esc 
23 # 



2b 
33 
3b 
43 
4b 
53 
5b 
63 
6b 
73 
7b 



+ 
3 

C 
K 

S 

[ 
c 
k 

s 



1004 


eot 1 


1014 


np 1 


1024 


dc4l 


1034 


fs 1 


1044 


$ 1 


1054 


9 ' 


1064 


4 1 


1074 


< 1 


1104 


D 1 


1114 


L 1 


1124 


T 1 


1134 


\ 1 


1144 


d 1 


1154 


1 1 


1164 


t 1 


1174 


1 1 


1 04 


eot 1 


1 0c 


np 1 


1 14 


dc4l 


1 lc 


fs 1 


1 24 


$ 1 


1 2c 


» ' 


1 34 


4 1 


1 3c 


< 1 


1 44 


D 1 


1 4c 


L 1 


1 54 


T 1 


1 5c 


\ 1 


1 64 


d 1 


1 6c 


1 1 


1 74 


t 1 


1 7c 


1 1 



005 
015 
025 
035 
045 
055 
065 
075 
105 
115 
125 
135 
145 
155 
165 
175 



enq 

cr 

nak 

gs 
% 



E 
M 
U 

] 
e 
m 
u 



} 



05 enq 
Od cr 
15 nak 
Id gs 

25 % 
2d - 
35 5 
3d = 
45 E 
4d M 
55 U 
5d ] 
65 e 
6d m 
75 u 
7d } 



1006 


ackl 


1016 


so 1 


1026 


synl 


1036 


rs 1 


1046 


& 1 


1056 




1066 


6 1 


1076 


> 1 


1106 


F 1 


1116 


N 1 


1126 


V 1 


1136 


A | 


1146 


f 1 


1156 


n 1 


1166 


v 1 


1176 


~ 1 


1 06 


ackl 


1 Oe 


so 1 


1 16 


synl 


1 le 


rs 1 


1 26 


& 1 


1 2e 


. | 


1 36 


6 1 


1 3e 


> 1 


1 46 


F 1 


1 4e 


N 1 


1 56 


V 1 


1 5e 


A | 


1 66 


f 1 


1 6e 


n 1 


1 76 


v 1 


1 7e 


~ 1 



007 


bell 


017 


si 1 


027 


etbl 


037 


us 1 


047 


' 1 


057 


/ 1 


067 


7 1 


077 


? 1 


107 


G 1 


117 


O 1 


127 


W 1 


137 




147 


g 1 


157 


o 1 


167 


w 1 


177 


dell 


07 


bell 


Of 


si 1 


17 


etbl 


If 


us 1 


27 


' 1 


2f 


/ 1 


37 


7 1 


3f 


? 1 


47 


G 1 


4f 


O 1 


57 


W 1 


5f 




67 


g 1 


6f 


o 1 


77 


w 1 


7f 


dell 



Files 



/usr/pub/ascii 
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environ (7) 
Name 

environ - user environment 

Syntax 

extern char **environ; 

Description 

An array of strings, called the environment, is made available by execve when a 
process begins. By convention, these strings have the form "name=value". The 
following names are used by various commands: 

PATH The sequence of directory prefixes that sh, t ime, and nice apply in 

searching for a file known by an incomplete path name. The prefixes are 
separated by a colon (:). The login(l) command sets 

PATH=:/usr/ucb: /bin: /usr/bin. 

HOME A user's login directory, set by login from the password file passwd. 

TERM The kind of terminal for which output is to be prepared. This 

information is used by commands, such as nrof f or plot, which may 
exploit special terminal capabilities. See /etc/termcap in 
termcap(5) for a list of terminal types. 

SHELL The file name of the user's login shell. 

TERMCAP The string describing the terminal in TERM or the name of the termcap 
file. For further information, see termcap(5) and termcap(3x). 

EXINIT A startup list of commands read by ex, edit, and vi. 

USER The login name of the user. 

PRINTER The name of the default printer to be used by lpr, lpq, and lprm. 

Further names may be placed in the environment by the export command and 
"name=value" arguments in sh, or by the setenv command if you use csh. 
Arguments can also be placed in the environment at the point of an execve. It is 
unwise to conflict with certain sh variables that are frequently exported by 

.profile files: MAIL, PS1, PS2, and IFS. 



See Also 



csh(l), ex(l), login(l), sh(l), execve(2), system(3), termcap(3x), passwd(5), 
termcap(5) 
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RISC hier(7) 



Name 



hier - file system hierarchy 



Description 



The following is a brief description of the root file system. The major directory 
hierarchy and representative files are listed. 

Symbolic links can be included in the files to provide backward compatibility. To 
display the links, type: 

% Is -1 



See the Guide to Disk Maintenance for more detailed information. 

/ Directory for root file system. This file system is separated into nonsharable 

data, (root (/)) and sharable data, (/usr). These two file systems are 
each divided into the following types: static data, variable data, and 
executable data. 

/bin Directory for the single user executable data files. 

/bin/init Parent of all processes, init(8). 

/bin/mount 

Mount program, mount(8). 

/dev Directory for devices. 
MAKEDEV 

Shell script to create special files 
MAKEDEV.local 

Site-specific part of MAKEDEV 

Main console, tty(4) 

SCSI disks, rz(4) 

Raw SCSI disks, rz(4) 

Tapes 

Tapes 

Terminals, tty(4) 



console 

rz 

rrz* 

rmt* 

mrmt* 

tty* 



/etc 



Directory for the machine-specific static data files and shell scripts for 

booting. 

crontab System clock daemon table, crontab(5) 

disktab Disk characteristics and partition tables, disktab(5) 

fstab File system configuration table, f stab(5) 

group Group file, group(5) 

hosts Host name-to-network address mapping file, hosts(5) 

motd Message-of-the-day file, login(l) 

networks Network name-to-network number mapping file, 

networks(5) 

passwd Password file, passwd(5) 

protocols Name-to-number mapping file, protocols(5) 

re Shell script to bring the system to multiuser mode 
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hier(7) RISC 



rclocal Site-dependent portion of re 

remote Names and description of remote hosts for t ip(lc) and 

remote(5) 
services Network services definition file, services(5) 
termcap Description of terminal capabilities, termcap(5) 
ttys Properties of terminals, tty s(5) 



/lib Symbolic link to /us r/ lib . 

/lost+found 

Directory for connecting detached files for f sck(8). 

/sys Symbolic link, normally to /usr/sys. 

/tmp Directory for temporary files (see also /usr/tmp). 
e* Used by ed(l) 

ctm* Used by cc(l) 



/usr General purpose directory, on which the /usr file system is normally 

mounted (see description that follows). 

/var Directory for variable length files, such as spool, administrative, and 

temporary files. These files can also be located in /usr/var. See the 
Guide to Disk Maintenance. 

/vmunix Kernel image 

The /usr directory contains the sharable data. The following is a brief description of 
the /usr file system. The major directory hierarchy and representative files are 
listed. 

/usr Root directory for /usr file system. 

/usr/adm Directory for administrative information, which is now a symbolic link 
to /var/adm. 

crash Directory for crash dumps 
vmcore.?,vmunix.? Crash dump files 
lpacct Line printer accounting, lpr(l) 
tracct Phototypesetter accounting, troff(l) 
wtmp Login history, utmp(5) 
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/usr/bin Directory for the shared executable data files, including utility programs 
and Shell scripts. 
as assembler 
cc C compiler executive (see also /usr/lib/ccom and 

/usr/lib/cpp) 
csh C shell 



/usr/dict Directory for word lists. 

spellhist History file, spell(l) 
words Word list, look(l) 



/usr/doc Directories containing files for the Vol.2 documentation. 
as Assembler manual 
c C manual 



/usr/etc Directory for utility programs and shell scripts. 

/usr/etc/cron 

Clock daemon, cron(8). 

/usr/etc/dump 

Dump program, dump ( 8 ) . 

/usr/examples 

A directory where components of the base system and Digital's 
separately licensed products can locate code examples, scripts, and 
demos for customers to use. A typical use is to complement printed 
documentation. 

/usr/games Directory for games. 

hangman Hangman game 

lib Library directory for games 



/usr/etc/getty 

Part of login, getty(8). 
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hier(7) RISC 



/usr/include 



Directory for standard #include files. 

a.out.h Object file layout, a . out(5) 
math.h matherr(3m) 
stdio.h Standard I/O, intro(3s) 

sys Symbolic link to /sys/h (system generation #include 

files) 



/usr/lib Directory for the shared static data files, such as object libraries. 

atrun System scheduler, at(l) 

cpp C preprocessor 

libca System calls and standard I/O (2,3,3S) 

font Directory for * r o f f ( 1 ) fonts 

lint Directory for utility files for lint (1) 

tmac Directory for * r o f f ( 1 ) macros 

units Data file of conversion tables for u n i t s ( 1 ) 

uucp Directory for uucp(lc) programs and data 



/usr/man Directory for unformatted and preformatted reference (manual) pages. 
catl Section 1 (preformatted) 

cat2 Section 2 (preformatted) 
cat3 Section 3 (preformatted) 



manl Section 1 (unformatted) 
man2 Section 2 (unformatted) 
man3 Section 3 (unformatted) 



/usr/mdec Directory for ULTRIX boot files. 
/usr/msgs Directory for messages, msgs(l). 
/usr/new Directory for binaries of new versions of programs. 

/usr/preserve 

Directory for editor temp files preserved after crashes or hangups. 

/usr/skel Directory for sample user startup files. 
.cshrc Startup file for csh(l) 
.login Login startup file for csh(l) 
.mailrc Startup file for ma i 1 ( 1 ) 
.profile Startup file for sh(l) 
.project Lists information used by f inger(l) 
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/usr/spool Directory for delayed execution files, which is now a symbolic link to 

/var/spool . 



/usr/src 



/usr/sys 



See Also 



at 
lpd 



mail 



uucp 



Directory used by at(l) 
Directory used by lpr(l) 

lock Present when line printer is active 
cf* Copy of file to be printed, if necessary 
df* Daemon control file, lpd(8) 
tf* Transient control file (exists while lpr is working) 
Mailboxes for ma i 1 ( 1 ) 

name Mail file for user name 

name.lock Lock file (exists while name is receiving 
mail) 
Work files and staging area for uucp(lc) 
LOGFILE Summary log 



Generic sources. 

usr.bin User sources 

troff nrof f and trof f sources 

term Directory of description files for new printers 

Directory for system files. 

b.mips BINARY for MIPS 
b.vax BINARY for VAX 

fs Filesystem SRC 

net Netword SRC 

mips MlPS-specific SRC 

vax VAX-specific SRC 

data System data files 

conf/{mips,vax} 

Configuration files 
h #include files 

SAS Standalone system 

sys Machine independent SRC 



/usr/tmp Symbolic link to /var/tmp . 



apropos(l), find(l), finger(l), grep(l), ls(l), whatis(l), whereis(l), which(l), 

ncheck(8) 

Guide to Disk Maintenance 
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hier(7) VAX 
Name 

hier - file system hierarchy 

Description 

The following is a brief description of the root file system. The major directory 
hierarchy and representative files are listed. 

Symbolic links can be included in the files to provide backward compatibility. To 
display the links, type: 

% Is -1 

See the Guide to Disk Maintenance for more detailed information. 

/ Directory for root file system. This file system is separated into nonsharable 

data (root (/)) and sharable data (/usr). These two file systems are each 
divided into the following types: static data, variable data, and executable 
data. 

/bin Directory for the single user executable data files. 

/bin/init Parent of all processes, init(8). 

/bin/mount 

Mount program, mount(8). 

/dev Directory for devices. 
MAKEDEV 

Shell script to create special files 
MAKEDEVJocal 

Site-specific part of MAKEDEV 
console Main console, tty(4) 
hp* disks, hp(4) 

rhp* Raw disks, hp(4) 
ra* UNIBUS disks, ra(4) 

tty* Terminals, tty(4) 



/etc Directory for the machine-specific static data files and shell scripts for 

booting. 

crontab System clock daemon table, crontab(5) 

disktab Disk characteristics and partition tables, disktab(5) 

fstab File system configuration table, f stab(5) 

group Group file, group(5) 

hosts Host name-to-network address mapping file, ho s t s (5) 

motd Message-of-the-day file, login(l) 

networks Network name-to-network number mapping file, 

networks(5) 

passwd Password file, passwd(5) 

protocols Name-to-number mapping file, protocols(5) 

re Shell script to bring the system to multiuser mode 

rclocal Site-dependent portion of re 
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remote 

services 
termcap 
ttys 



Names and description of remote hosts for tip(lc) and 

remote(5) 

Network services definition file, services(5) 

Description of terminal capabilities, termcap(5) 

Properties of terminals, ttys(5) 



/lib Symbolic link to /usr/lib. 

/lost+found 

Directory for connecting detached files for f sck(8). 

/sys Symbolic link, normally to/usr/sys. 

/tmp Directory for temporary files (see also /usr/tmp). 
e* Used by ed(l) 

ctm* Used by cc(l) 



/usr General purpose directory, on which the /us r file system is normally 
mounted (see description that follows). 

/var Directory for variable length files, such as spool, administrative, and 

temporary files. These files can also be located in /usr/var. See the 
Guide to Disk Maintenance. 

/vmunix Kernel image 

The /usr directory contains the sharable data. The following is a brief description of 
the /usr file system. The major directory hierarchy and representative files are 
listed. 

/usr Root directory for /usr file system. 

/usr/adm Directory for administrative information, which is now a symbolic link 
to /var/adnt. 

crash Directory for crash dumps 
vmcore.?,vmunix.? Crash dump files 
Ipacct Line printer accounting, lpr(l) 
tracct Phototypesetter accounting, troff(l) 
vaacct, vpacct 

Varian and Versatec accounting for vpr(l), vtrof f(l), 

pac(8) 
wtmp Login history, utmp(5) 



/usr/bin Directory for the shared executable data files, including utility programs 
and Shell scripts. 
as assembler 

cc C compiler executive (see also /lib/ccom, /lib/cpp, and 
/lib/c2) 
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csh C shell 



/usr/dict Directory for word lists. 

spellhist History file, spell(l) 
words Word list, look(l) 



/usr/doc Directories containing files for the Vol.2 documentation. 
as Assembler manual 
c C manual 



/usr/etc Directory for utility programs and shell scripts. 

/usr/etc/cron 

Clock daemon, cron(8). 

/usr/etc/dump 

Dump program, dump ( 8 ) . 

/usr/examples 

A directory where components of the base system and Digital's 
separately licensed products can locate code examples, scripts, and 
demos for customers to use. A typical use is to complement printed 
documentation. 

/usr/games Directory for games. 

hangman Hangman game 

lib Library directory for games 



/usr/etc/getty 

Part of login, getty(8). 

/usr/include 

Directory for standard #include files. 

a.out.h Object file layout, a . out(5) 
math.h matherr(3m) 
stdio.h Standard I/O, intro(3s) 

sys Symbolic link to / sys /h (system generation #include 

files) 



/usr/lib Directory for the shared static data files, such as object libraries. 
atrun System scheduler, at(l) 
ccom C compiler proper 
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cpp C preprocessor 

c2 C code improver 

libca System calls and standard I/O (2,3,3S) 

font Directory for *rof f (1) fonts 

lint Directory for utility files for lint(l) 

tmac Directory for nrof f (1) and *rof f(l) macros 

units Data file of conversion tables for unit s(l) 

uucp Directory for uucp(lc) programs and data 



/usr/man Directory for unformatted and preformatted reference (manual) pages. 
catl Section 1 (preformatted) 
cat2 Section 2 (preformatted) 

cat3 Section 3 (preformatted) 



manl Section 1 (unformatted) 
man2 Section 2 (unformatted) 
man3 Section 3 (unformatted) 



/usr/mdec Directory for ULTRIX boot files. 

/usr/msgs Directory for messages, msgs(l). 

/usr/new Directory for binaries of new versions of programs. 

/usr/preserve 

Directory for editor temp files preserved after crashes or hangups. 

/usr/skel Directory for sample user startup files 
.cshrc Startup file for csh(l) 
.login Login startup file for csh(l) 
.mailrc Startup file for mail(l) 
.profile Startup file for sh(l) 
.project Lists information used by f inger(l) 

/usr/spool Directory for delayed execution files, which is now a symbolic link to 
/var/spool. 

at Directory used by at(l) 
Ipd Directory used by lpr(l) 

lock Present when line printer is active 
cf* Copy of file to be printed, if necessary 
df* Daemon control file, lpd(8) 
tf* Transient control file (exists while lpr is working) 
mail Mailboxes for ma i 1(1) 

name Mail file for user name 

name. lock Lock file (exists while name is receiving 
mail) 
uucp Work files and staging area for uucp(lc) 
LOGFILE Summary log 
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/usr/src 



/usr/sys 



Generic sources. 

usr.bin User sources 

troff nrof f and trof f sources 

term Directory of description files for new printers 



Directory for 


system files. 


BINARY 


System object files, make(l) 


cassette 


Files for boot cassette 


conf 


Configuration files, conf ig(8) 


data 


Drive partition tables 


floppy 


Files for floppy disk 


h 


# include files 


mdec 


Headers for 11/750 boot blocks 


net 


General network files 


netimp 


IMP network files 


netinet 


DARPA internet network files 


netpup 


PUP network files 


stand 


Standalone boot binaries 


sys 


Machine-dependent system files 


vax 


VAX-specific system files 


vaxif 


Network interface drivers for the VAX 


vaxmba 


Drivers for devices on the MASSBUS 


vaxuba 


Drivers for devices on the UNIBUS 



/usr/tmp Symbolic link to /var/tmp. 



See Also 



apropos(l), find(l), finger(l), grep(l), ls(l), whatis(l), whereis(l), which(l), 
crontab(5), ncheck(8) 
Guide to Disk Maintenance 
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Name 

mailaddr - mail addressing description 

Description 

Mail addresses are based on the ARPANET protocol listed in the SEE ALSO section 
of this reference page. In addition, the DECnet address format can be used, if 
DECnet is installed on your system. 

To send mail to DECnet users, use the following address format: 

nodename: :username 

In this case, nodename is the name of the DECnet system, or host, on which the 
target user resides. 

Addresses based on the ARPANET protocol use the following general format: 

user@domain 

A domain is a hierarchical dot-separated list of subdomains. For example, the 
following address is interpreted from right to left: 

eric@monet. Berkeley. ARPA 

In the previous example, the message is directed to the ARPA name tables (which do 
not correspond exactly to the physical ARPANET). The message then proceeds to 
the Berkeley gateway, after which it is directed to the local host monet. When the 
message reaches monet, it is delivered to the user eric. 

Unlike some other forms of addressing, this does not imply any routing. Thus, an 
address that is specified as an ARPA address can travel by an alternate route if that 
route is more convenient or efficient. For example, from Berkeley, the message 
could go directly to monet over the Ethernet, rather than using the Berkeley 
ARPANET gateway. 

Abbreviations. In some instances, you do not have to type an entire domain name. 
Generally, any information that follows the first dot may be omitted if the sending 
and receiving domains are the same. For example, a user on calder.Berkeley.ARPA 
can eliminate the .Berkeley.ARPA when sending to eric@monet, because the sending 
and receiving hosts are the same. 

Other abbreviations are permitted when conflicts do not exist. For example, Berkeley 
ARPANET hosts can be accessed without adding the .ARPA, if their names do not 
conflict with a local host name. 

Compatible Addresses. To provide compatibility with the previous mail system, 
some old address formats are converted to the new format. In particular, host::user is 
converted to user@host providing consistency with the rcp(lc) command. 

The syntax hostluser is converted to user@host.UUCP. Before being sent on, 
user@host.UUCP is normally converted back to the hostluser form. This conversion 
is done for compatibility with older UUCP hosts. 

The current implementation cannot automatically route messages through the UUCP 
network. Thus, you must explicitly tell the mail system all the hosts your messages 
must be sent through to arrive at its final destination. 
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Case Distinctions. Domain names (that is, anything following the at sign (@)) can 
be a combination of upper- and lowercase characters with the exception of UUCP 
hostnames. Most hosts accept both upper- and lowercase in user names, with the 
exception of MULTICS sites. 

Differences with ARPA Protocols. Although the UNIX addressing scheme is based 
on the ARPA mail addressing protocols, there are some significant differences. 

Currently, the only top level domain defined by ARPA is the .ARPA domain itself. 
This is further restricted to having only one level of host specifier. That is, the 
addresses that ARPA accepts must be in the format user@host.ARPA (where 'host' 
is one word). For example, the following address is not legal under the ARPA 
protocols: 

ericSmonet. Berkeley. ARPA 

Thus, the previous address would be converted to a different format on output to the 
ARPANET. For example: 

eric%monet@Berkeley.ARPA 

Route-addrs. In some instances, a message must be routed through several hosts to 
reach its final destination. Usually, this action is invisible to the sender; however, it 
is sometimes desirable to route a message manually. Addresses that are moved 
manually are called route-addrs. The syntax is as follows: 

Ohosta, @hostb:user@hostc> 

The previous example directs the message to hosta, to hostb, and finally to hostc. 
This route is used regardless of a more efficient path to hostc. 

Route-addrs occur frequently on return addresses, because they are generally 
augmented by the software at each host. It is possible to ignore all but the user@host 
part of the address to determine the actual sender. 

Postmaster. Every site must have a user or user alias designated as postmaster to 
which problems with the mail system can be addressed. 

CSNET. To send messages to CSNET, use the following syntax: 

user.host@UDel-Relay 



See Also 



mail(l), sendmail(8) 

Crocker, D. H., Standard for the Format of Arpa Internet Text Messages, RFC822 
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Name 



man - the man macro package for online reference pages 



Syntax 



tbl file... | nroff [ -nN ] [ -rll ] -man | col | 
tbl file... | *troff [ -nN ] [ -rll ] -man | ... 



Description 



The man macro package is used to format reference manual pages for online viewing 
or printing. The installed reference pages are formatted by the man(l) and the 
catman(8) commands, using the man macro package. 

The page size is 80 columns by 66 lines for nroff output and is 8.5" x 11" when 
formatted with *trof f text formatters. Page numbers appear at the bottom of each 
output page with odd page numbers appearing on the right side and even page 
numbers appearing on the left side. 

The format of the ULTRIX online reference pages is determined by the 

man . repro(7) macro package. The man macros are a compatible subset of the 

man . repro macros. 

Macros 

The following describes the macros in the man macro package. 

Any text argument can range from zero to six words. Quotation marks (" ") can be 
used to include blanks in words. If text is not specified, special treatment is applied 
to the next input line that has text to be printed. In this way, . I can be used to 
italicize a whole line or . SM followed by . B to make small bold letters. 

A prevailing indent distance is remembered between successive indented paragraphs, 
and is reset to a default value upon reaching a nonindented paragraph. Default units 
for indents i are ens (an en is 1 nroff character or 1/2 em space in current point 
size). 

Typeface and size are reset to default values before each paragraph, and after 
processing font and size setting macros. 

.B [ text... ] Sets text text in boldface. If no text is specified, the next text line is 
set in boldface. 

.BI wordl word! [ words... ] 

Sets wordl in boldface, wordl in an italic typeface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

•BR wordl wordl [ words... ] 

Sets wordl in boldface, wordl in a roman typeface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 
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.CT character 

Prints the keyboard control character indicator <CYKLIcharacter> . For 
example, . CT A prints as <CTRL/A> . 

.CW Sets text in constant width font until another font change is found. 

.De Ends an unfilled display block (started by . Ds). Also ends automatic 

centering, if it was in effect. 

.Ds Starts an unfilled display block. Text between . Ds and . De is 

printed in a roman typeface, with 'no fill' mode (no wrapping and 
blank lines allowed) in effect. The display block is set flush left. 

.DT Restores default tabs. Default tabs are set to .5 inches, starting with 

.5i, li, ... . 

.EE Ends an example and restores basic text defaults and indents. 

.EX [ i ] Starts an example. Text between . EX and . EE is printed in a 

constant width font with 'no fill' mode (no wrapping and blank lines 
allowed) in effect. The example is set flush left unless an indent i is 
specified. Units of i are ens. 

.G [ text... ] Sets text in a sans-serif typeface. If no text is specified, the next text 
line is set in a sans-serif typeface. 

.GL [ text... ] Sets text in a sans-serif italic typeface. If no text is specified, the next 
text line is set in a sans-serif italic typeface. 

.HB [ words... ] 

Sets the text in underline mode or in a sans-serif bold typeface, 
depending on the type of text formatter (nrof f or trof f ). If the 
text formatter is of type nrof f, the next 999 input lines are formatted 
in underline mode (nrof f italic mode), or all the lines up to a font 
change are formatted in underline mode, depending on which limit is 
encountered first. If the text formatter is of type t rof f , text is set in 
a sans-serif bold typeface until a font change is encountered. Up to 
nine words can also be specified as arguments. 

.HP i Begins a paragraph with a hanging indent of i ens. 

.1 [ text... ] Sets text in an italic typeface. If no text is specified, the next text line 
is set in an italic typeface. 

.11 word Sets a temporary indent to the length of the specified word. 

.12 word Reverses one line and then sets a temporary indent to the length of the 
specified word. 

.IB wordl word2 [ words... ] 

Sets wordl in an italic typeface, wordl in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" ")• 

.IP x i Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. Tag x appears in 
bold typeface. 
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.IR wordl word! [ words... ] 

Sets wordl in an italic typeface, wordl in a roman typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

•LP Same as the . PP macro. This macro is obsolete, but is provided for 

backwards compatibility. 

.MS reference jyage section _subsection [ punctuation ] 

Sets reference _page immediately followed by section subsection in 
parentheses followed by optional punctuation, using fonts that 
distinguish this reference page reference from ordinary text. For 
example, manual(section). 

•NE Ends a note. Also cancels automatic centering if it was in effect. 

.NT [ header 1 ] [ C ] 

.NT [ C ] [ header! ] 

Starts a note. If no arguments are specified, the default header for the 
note is 'NOTE'. If the first argument is the letter 'C, all text in the 
note is centered, for the next 99 text lines or until the . NE macro is 
called, whichever comes first. If the first argument is not 'C, it 
becomes the header of the note, even if header! is also specified. The 
header2 argument becomes the header of the note if the first argument 
is «C\ 

.PD [ v ] Sets the interparagraph distance to v vertical spaces. Resets the 

distance to the default value if v is omitted. 

.PN x [ y ] Sets x in an italic or constant width typeface (depending on the 

*rof f formatter type) and then reverts to the previous typeface. The 
optional argument y is appended to x with no space, but printed in the 
previous typeface. The x argument is usually a path name; y is usually 
punctuation. 

.Pn xy[z] Sets x in the current typeface, sets y in an italic or constant width 

typeface (depending on the *rof f formatter type) and appends it to x, 
and finally reverts to the previous typeface. The optional argument z is 
appended to y, but printed in the previous typeface. Spaces are 
removed between x, y, and z, unless quotation marks (" ") are used to 
enclose strings with spaces. The x argument is usually a fixed path 
name; y is usually a variable path name; and z is usually punctuation. 

.PP Starts a block paragraph. Sets the prevailing indent to .5i for nrof f 

and four picas for *trof f text formatters. 

.R Sets the text in a roman typeface until another font change is 

encountered. Also ends nrof f underline mode if it was in effect. 

.RB wordl wordl [ words... ] 

Sets wordl in a roman typeface, wordl in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

•RE [ k ] Returns to the kth relative right shift indent level. (Restores the left 

margin to the position prior to the kth . RS call). Specifying k=0 is 
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equivalent to specif ying k=l. If k is omitted, . RE restores the left 
margin to the most recent previous position. When k=l or 0, the 
default . RS indent increment is restored. 

.RI wordl word2 [ words... ] 

Sets wordl in a roman typeface, word2 in an italic typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

•RN Prints the return character indicator, < RETURN > . 

.RS [ i ] Shifts the left margin to the right (relatively) the amount of i ens. The 

. RS macro calls can be nested up to nine levels. If i is not specified 
for the first . RS call, the relative right shift increases .5 inch for 
nrof f , and four picas for *trof f text formatters. Nested .RS calls 
increment the relative indent by i ens, or by .25 inch for nrof f, or by 
2 picas for *trof f text formatters. 

.SH text Creates a section header. 

.SM [ text ] Sets text to be two points smaller than the current point size. If no 
text is specified, the next text line is set in the smaller point size. 

.SS text Creates a subsection header. 

.TB [ words... ] 

Same as the . HB macro. This macro is is obsolete, but is provided for 
backwards compatibility. 

.THnc[s][a][f][x] 

Begins a new reference page and sets the page title. Also sets up 
headers and footers for output pages, sets up all defaults and traps, and 
calls the . DT and . PD macros. The title appears as a header on all 
pages of the formatted reference page. The n argument is the reference 
page name. The c argument is the primary section number or letter. 
The s argument is the subsection, if any. The a argument is for an 
optional machine architecture specific label; for example "VAX". 
The /argument optionally alters a portion of the page footer. The x 
argument is for optional extra commentary; for example 
"Unsupported". 

Fields n, c, and 5 appear together at the top of each output page (see 
the top of this page for an example). These fields alternate between 
the right top and left top of a page header, corresponding to odd and 
even page numbers. Field a appears opposing the page name in the 
header when formatted with nrof f , but appears as a bleed tab when 
formatted with *trof f text formatters. The /argument appears in 
the page footer on the inside edge of the page (left for odd page 
numbers, right for even). The x argument appears underneath the page 
name in the header. 

The last three fields are optional. To skip a field, specify a pair of 
quotation marks ("") in the field to be skipped. 

.TP i Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. 
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.VE End a vertical margin bar. 

.VS [ 4 ] Starts a vertical margin bar, if '4' is specified; otherwise, the macro 

does nothing. 

Macros That Cause Line Breaks 

The following macros cause line breaks: 



De 


Ds 


EE 


EX 


HP 


IP 


LP 


PP 


RE 


SH 


SS 


TH 


TP 













Macros That Need Text Lines 

The following macros affect the following line of text if they are specified in the 
input without arguments: 



B 


BI 


BR 


G 


GL 


I 


IB 


IR 


RI 


RB 


SH 


SS 


SM 













Automatic hyphenation is turned on. However, last lines (ones that will cause a trap) 
are not hyphenated and the last and first two characters of a word are not split off. 

Characters printed from the Special Font are artificially bolded by three units 
whenever the current font is '3'. 

The default page size is 80 columns by 66 lines for nrof f output and 8.5" x 11" for 
output generated by *trof f text formatters. The text area is horizontally placed on 
the page so that the effective page margin is .5 inches for nrof f and 7.5 picas for 
*trof f text formatters. 

The . TH macro sets up the following defaults: 

• Text is set in "noadjust" mode; the right margin is ragged. 

• The default interparagraph distance is lv for nrof f and .5v for *trof f text 
formatters. 

• The basic text indent is .5 inches for nrof f and four picas for *trof f text 
formatters, from the left margin. 

• The maximum text line length is 7 inches for nrof f and 36 picas for *trof f 
text formatters. 

• Sets tab stops every .5 inches. 

• The basic text point size is 1 1 points, with line spacing set to 12 points. 

• The basic text font is "R" (a roman typeface). 



Reference page headers, section headers, and subsection headers are set in a 
sans-serif bold typeface. 



Options 



-niV Numbers the first generated page as N. 

-rll Turns on line double-spacing mode. 
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Restrictions 

Predefined Registers 

The following registers are predefined by the man macro package and should not be 
changed: 

PO Page offset and page margin 

IN Left margin indent relative to the section headers 

LL Line length including IN 

PL Page length 

The register T is predefined when you specify the *rof f -rl option. Its default 
value is 0. The man(l) command does not use this option. 

Reserved Registers 

The following registers are reserved for internal use by the man, man . nopage, and 
man . repro macro packages: 

Al DX EX 1 p p# 
PF 

In addition, registers beginning with the characters ')%']% and '}' are also reserved 
for internal use. 

Registers predefined by the nrof f(l), tbl(l), commands, and the *eqn and 
*trof f text preprocessors and formatters should not be redefined. 

Predefined Strings 

The following strings are predefined by the man macro package and should not be 
changed: 

lq " if nrof f, "if *troff 

rq "if nroff, "if *troff 

S Command string to change type size to 10 points. 

Reserved Strings and Macros 

The following string and macro names are reserved for internal use by the man, 

man . nopage, and man . repro macro packages: 

## Al BD BK CD D 

DE DS HH ID LD NO 

NX P UF ya yn yl 

ys 

In addition, names begining with the characters ')', ']'» and '}' are also reserved for 
internal use. 

Names predefined by the nrof f (1), tbl(l), commands, and the *eqn and *trof f 
text preprocessors and formatters should not be redefined. 
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.TH Macro Restrictions 

The section number should only be 1-8, 'n', '1', 'o', or 'p'. Other values might not 
be recognized by the man(l) or catman(8) commands. 

Sections 6, 7, 'n', '1', 'o\ and 'p' do not currently have subsections, so subsections 
should not be specified. 

The architecture field (a) should not exceed four characters. A value longer than four 
characters might print outside the right page margin. 

Reference pages containing *eqn commands should be preprocessed by an *neqn 
text preprocessor before being installed on the system. 

Reference pages containing tbl(l) commands must not be preprocessed before being 
installed on the system. 

The Name Section 

The catman(8) command assumes the Name section of a reference page has the 
following format: 

name[, name, name ...] \- explanatory text 

There should be at least one space after any comma and only one space following the 
"backslash hyphen" (V). There should not be any *rof f commands in the 
explanatory text. The explanatory text should be brief. The catman(8) command 
combines information in the Name section with parameters of the . TH macro to 
create an entry in a database searched by the apropos(l), man(l), and whatis(l) 
commands. 

Portability Considerations 

The ULTRIX man macro packages contain extensions and enhancements borrowed 
from other macro packages. If you have a need to write portable reference pages, 
you should not use the following macros: 



CT 


CW 


De 


Ds 


EE 


EX 


G 


GL 


HB 


HP 


11 


12 


LP 


MS 


NE 


NT 


PN 


Pn 


R 


RN 


TB 


UF 







The LP and TB macros are obsolete. 

The ULTRIX man . TH macro differs from other implemenations of the . TH macro. 
The primary differences are in the placement of the page title, and third and fifth 
fields in the *rof f output. The page title (the page name and section number) is 
commonly placed on both sides of the page header in other implementations. The 
more common placement of the third field is in the center of the page footer. The 
more common placement of the fifth field is in the center of the page header. 

Use of the tbl(l) and *eqn commands should be avoided, because the version of 
the man(l) command in some other implementations might not preprocess reference 
pages through the tbl(l) command. The *eqn commands also might not be 
installed. 
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Files 

/usr/lib/tmac/tmac . an The man macro package file 

See Also 

col(l), man(l), nroff(l), tbl(l), man.nopage(7), man.repro(7), catman(8) 
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Name 



man.nopage - the man.nopage macro package for printing reference pages 



Syntax 



tbl file... | nroff [ -niV ] [ -rpS ] [ -rll ] -man.nopage | col 
tbl file... j *troff [ -nTV ] [ -rpS ] [ -rll ] -man.nopage | ... 



Description 



The man . nopage macro package is used to format reference manual pages for 
unpaginated viewing or for printing on line printers. The installed reference pages 
are formatted by the man(l) and the catman(8) commands, using the man macro 
package. 

The page width is 80 columns when formatted by the nrof f(l) command and is 8.5 
inches when formatted with *trof f text formatters. The output is unpaginated 
when formatted by the nroff command, hence the name 'nopage'. The output is 
paginated when formatted by *trof f text formatters, with page numbers appearing 
at the bottom of each output page with odd page numbers appearing on the right side 
and even page numbers appearing on the left side. The *trof f output is similar to 
the output generated with the man . repro(7) macro package. 

The format of the ULTRIX online reference pages is determined by the 

man . repro(7) macro package. The man . nopage macros are a compatible subset 

of the man . repro macros. 



Macros 

The following describes the macros in the man macro package. 

Any text argument can range from zero to six words. Quotation marks (" ") can be 
used to include blanks in words. If text is not specified, special treatment is applied 
to the next input line that has text to be printed. In this way, . I can be used to 
italicize a whole line or . SM followed by . B to make small bold letters. 

A prevailing indent distance is remembered between successive indented paragraphs, 
and is reset to a default value upon reaching a nonindented paragraph. Default units 
for indents i are ens (an en is 1 nroff character or 1/2 em space in current point 
size). 

Typeface and size are reset to default values before each paragraph, and after 
processing font and size setting macros. 

.B [ text... ] Sets text text in boldface. If no text is specified, the next text line is 
set in boldface. 

.BI wordl word.2 [ words... ] 

Sets wordl in boldface, wordl in an italic typeface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.BR wordl wordl [ words... ] 

Sets wordl in boldface, word! in a roman typeface, and then alternates 
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between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.CT character 

Prints the keyboard control character indicator < CTRL/ character > . For 
example, . CT A prints as <CTRL/A> . 

.CW Sets text in a constant width font until another font change is 

encountered. 

.De Ends an unfilled display block (started by . Ds). Also ends automatic 

centering, if it was in effect. 

.Ds Starts an unfilled display block. Text between .Ds and .De is 

printed in a roman typeface, with 'no fill' mode (no wrapping and 
blank lines allowed) in effect. The display block is set flush left. 

.DT Restores default tabs. Default tabs are set to .5 inches, starting with 

.5i, li, ... . 

.EE Ends an example and restores basic text defaults and indents. 

.EX [ i ] Starts an example. Text between . EX and . EE is printed in a 

constant width font with 'no fill' mode (no wrapping and blank lines 
allowed) in effect. The example is set flush left unless an indent i is 
specified. Units of / are ens. 

.G [ text... ] Sets text in a sans-serif typeface. If no text is specified, the next text 
line is set in a sans-serif typeface. 

.GL [ text... ] Sets text in a sans-serif italic typeface. If no text is specified, the next 
text line is set in a sans-serif italic typeface. 

.HB [ words... ] 

Sets the text in underline mode or in a sans-serif bold typeface, 
depending on the type of text formatter (nrof f or t rof f ). If the 
text formatter is of type nrof f , the next 999 input lines are formatted 
in underline mode (nrof f italic mode), or all the lines up to a font 
change are formatted in underline mode, depending on which limit is 
encountered first. If the text formatter is of type t rof f , text is set in 
a sans-serif bold typeface until a font change is encountered. Up to 
nine words can also be specified as arguments. 

.HP / Begins a paragraph with a hanging indent of i ens. 

.1 [ text... ] Sets text in an italic typeface. If no text is specified, the next text line 
is set in an italic typeface. 

.11 word Sets a temporary indent to the length of the specified word. 

.12 word Reverses one line and then sets a temporary indent to the length of the 

specified word. 

.IB wordl word! [ words... ] 

Sets wordl in an italic typeface, wordl in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 
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•IP x i Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. Tag x appears in 
bold typeface. 

.IR wordl wordl [ words... ] 

Sets wordl in an italic typeface, wordl in a roman typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

.LP Same as the . PP macro. This macro is obsolete, but is provided for 

backwards compatibility. 

.MS reference _page section _subsection [ punctuation ] 

Sets reference _page immediately followed by section _subsection in 
parentheses followed by optional punctuation, using fonts that 
distinguish this reference page reference from ordinary text. For 
example, manual(section). 

.NE Ends a note. Also cancels automatic centering if it was in effect. 

.NT [ headerl ] [ C ] 

.NT [ C ] [ headerl ] 

Starts a note. If no arguments are specified, the default header for the 
note is 'NOTE'. If the first argument is the letter 'C, all text in the 
note is centered, for the next 99 text lines or until the . NE macro is 
called, whichever comes first. If the first argument is not 'C, it 
becomes the header of the note, even if headerl is also specified. The 
headerl argument becomes the header of the note if the first argument 
is 'C. 

.PD [ v ] Sets the interparagraph distance to v vertical spaces. Resets the 

distance to the default value if v is omitted. 

.PN x [ y ] Sets x in an italic or constant width typeface (depending on the 

*rof f formatter type) and then reverts to the previous typeface. The 
optional argument y is appended to x with no space, but printed in the 
previous typeface. The x argument is usually a path name; y is usually 
punctuation. 

•Pn x y [ z ] Sets x in the current typeface, sets y in an italic or constant width 

typeface (depending on the *rof f formatter type) and appends it to x, 
and finally reverts to the previous typeface. The optional argument z is 
appended to y, but printed in the previous typeface. Spaces are 
removed between x, y, and z, unless quotation marks (" ") are used to 
enclose strings with spaces. The x argument is usually a fixed path 
name; y is usually a variable path name; and z is usually punctuation. 

.PP Starts a block paragraph. Sets the prevailing indent to .5i for nrof f 

and four picas for *trof f text formatters. 

.R Sets the text in a roman typeface until another font change is 

encountered. Also ends nrof f underline mode if it was in effect. 

.RB wordl wordl [ words... ] 

Sets wordl in a roman typeface, wordl in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
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Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.RE [ k ] Returns to the £th relative right shift indent level. (Restores the left 
margin to the position prior to the &th . RS call). Specifying k=0 is 
equivalent to specifying k=l. If k is omitted, . RE restores the left 
margin to the most recent previous position. When fc=l or 0, the 
default . RS indent increment is restored. 

.RI wordl word2 [ words... ] 

Sets wordl in a roman typeface, wordl in an italic typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" ")• 

.RN Prints the return character indicator, < RETURN > . 

.RS [ i ] Shifts the left margin to the right (relatively) the amount of i ens. The 

. RS macro calls can be nested up to nine levels. If i is not specified 
for the first . RS call, the relative right shift increases .5 inch for 
nrof f and four picas for *trof f text formatters. Nested . RS calls 
increment the relative indent by i ens, or by .25 inch for nrof f, or by 
2 picas for *trof f text formatters. 

.SH text Creates a section header. 

•SM [ text ] Sets text to be two points smaller than the current point size. If no 
text is specified, the next text line is set in the smaller point size. 

.SS text Creates a subsection header^ 

.TB [ words... ] 

Same as the . HB macro. This macro is is obsolete, but is provided for 
backwards compatibility. 

.THnc[s][a][f][x] 

Begins a new reference page and sets the page title. Also sets up 
headers and footers for output pages, sets up all defaults and traps, and 
calls the . DT and . PD macros. The title appears as a header on all 
pages of the formatted reference page. The n argument is the reference 
page name. The c argument is the primary section number or letter. 
The s argument is the subsection, if any. The a argument is for an 
optional machine architecture specific label; for example "VAX". 
The /argument optionally alters a portion of the page footer. The x 
argument is for optional extra commentary; for example 
"Unsupported". 

Fields n, c, and s appear together at the top of each output page (see 
the top of this page for an example). These fields alternate between 
the right top and left top of a page header, corresponding to odd and 
even page numbers. Field a appears opposing the page name in the 
header when formatted with nrof f , but appears as a bleed tab when 
formatted with *trof f text formatters. The /argument appears in 
the page footer on the inside edge of the page (left for odd page 
numbers, right for even). The x argument appears underneath the page 
name in the header. 
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The last three fields are optional. To skip a field, specify a pair of 
quotation marks ("") in the field to be skipped. 

,TP / Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. 

•VE End a vertical margin bar. 

.VS [ 4 ] Starts a vertical margin bar, if '4' is specified; otherwise, the macro 

does nothing. 

Macros That Cause Line Breaks 

The following macros cause line breaks: 
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Macros That Need Text Lines 

The following macros affect the following line of text if they are specified in the 
input without arguments: 
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Automatic hyphenation is turned on. However, last lines (ones that will cause a trap) 
are not hyphenated and the last and first two characters of a word are not split off. 

Characters printed from the Special Font are artificially bolded by three units 
whenever the current font is '3'. 

The default page width is 80 columns nrof f output and 8.5 inches for output 
generated by *trof f text formatters. The text area is horizontally placed on the 
page so that the effective page margin is .5 inches for nrof f and 7.5 picas for 
*trof f text formatters. 

The default page length is unlimited (unpaginated) for nerof f output, but is 11 
inches for output generated by *trof f text formatters. 

The . TH macro sets up the following defaults: 

• Text is set in "noadjust" mode; the right margin is ragged. 

• The default interparagraph distance is lv for nrof f and .5v for *trof f text 
formatters. 

• The basic text indent is .5 inches for nrof f and four picas for *trof f text 
formatters, from the left margin. 

• The maximum text line length is 7 inches for nrof f and 36 picas for *trof f 
text formatters. 

• Sets tab stops every .5 inches. 

• The basic text point size is 1 1 points, with line spacing set to 1 2 points. 

• The basic text font is "R" (a roman typeface). 

• Reference page headers, section headers, and subsection headers are set in a 
sans-serif bold typeface. 
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The default section number, which apepras like a "chapter" number in page footers 
is for *trof f output. There are no page footers for nrof f output. 

Options 

-n/V Numbers the first generated page as N. 

-rll Turns on line double-spacing mode. 

-rpS Sets the section number fo S. Section numbers appear in output page 

footers as S-N (chapter-page-number). 

Restrictions 

Predefined Registers 

The following registers are predefined by the man macro package and should not be 
changed: 

PO Page offset and page margin 

IN Left margin indent relative to the section headers 

LL Line length including IN 

PL Page length 

The register T is predefined when you specify the *rof f -rl option. Its default 
value is 0. The man(l) command does not use this option. 

The register 'p' is predefined when you specify the *rof f -rp option. Its default 
value is 0. The man(l) command does not use this option. 

Reserved Registers 

The following registers are reserved for internal use by the man, man . nopage, and 
man . repro macro packages: 

Al DX EX 1 p p# 
PF 

In addition, registers beginning with the characters ')',']', and '}' are also reserved 
for internal use. 

Registers predefined by the nrof f (1), tbl(l), commands, and the *eqn and 
*trof f text preprocessors and formatters should not be redefined. 

Predefined Strings 

The following strings are predefined by the man macro package and should not be 
changed: 

Iq "if nroff, " if *troff 

rq "if nroff, "if *troff 

S Command string to change type size to 10 points. 
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Reserved Strings and Macros 

The following string and macro names are reserved for internal use by the man, 
man . nopage, and man . repro macro packages: 

## Al BD BK CD D 

DE DS HH ID LD NO 

NX P UF ya yn yl 

ys 

In addition, names begining with the characters ')', ']', and '}' are also reserved for 
internal use. 

Names predefined by the nrof f (1), tbl(l), commands, and the *eqn and *trof f 
text preprocessors and formatters should not be redefined. 

.TH Macro Restrictions 

The section number should only be 1-8, 'n', T, V, or 'p'. Other values might not 
be recognized by the man(l) or catman(8) commands. 

Sections 6, 7, 'n', T, 'o', and 'p' do not currently have subsections, so subsections 
should not be specified. 

The architecture field {a) should not exceed four characters. A value longer than four 
characters might print outside the right page margin. 

Reference pages containing *eqn commands should be preprocessed by an *neqn 
text preprocessor before being installed on the system. 

Reference pages containing tbl(l) commands must not be preprocessed before being 
installed on the system. 

The Name Section 

The catman(8) command assumes the Name section of a reference page has the 
following format: 

name[, name, name ...] \- explanatory text 

There should be at least one space after any comma and only one space following the 
"backslash hyphen" (V). There should not be any *rof f commands in the 
explanatory text. The explanatory text should be brief. The catman(8) command 
combines information in the Name section with parameters of the . TH macro to 
create an entry in a database searched by the apropos(l), man(l), and whatis(l) 
commands. 

Portability Considerations 

The ULTRIX man macro packages contain extensions and enhancements borrowed 
from other macro packages. If you have a need to write portable reference pages, 
you should not use the following macros: 
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The LP and TB macros are obsolete. 



Files 



The ULTRIX man . TH macro differs from other implemenations of the . TH macro. 
The primary differences are in the placement of the page title, and third and fifth 
fields in the *rof f output. The page title (the page name and section number) is 
commonly placed on both sides of the page header in other implementations. The 
more common placement of the third field is in the center of the page footer. The 
more common placement of the fifth field is in the center of the page header. 

Use of the tbl(l) and *eqn commands should be avoided, because the version of 
the man(l) command in some other implementations might not preprocess reference 
pages through the tbl(l) command. The *eqn commands also might not be 
installed. 



/usr/lib/tmac/tmac . an . nopage 

The man . nopage macro package file 



See Also 

col(l), man(l), nroff(l), tbl(l), man(7), man.repro(7), catman(8) 
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Syntax 



manxepro - the man.repro macro package for typesetting reference pages 



tbl file... | nroff [ -niV ] [ -rpS ] [ -rll ] -man.repro | col 
tblfile... | *troff [ -nN ] [ -rpS ] [ -rll ] -man.repro | ... 



Description 



The man . repro macro package is used to format reference manual pages for 
printing or typsetting. This reference page was formatted by a *troff text 
formatter, using the man . repro macro package, nrof f(l) command, using the 
man . repro macro package, or was formatted by the man(l) and the catman(8) 
commands, using the man macro package. 

The page size is 80 columns by 66 lines for nroff output and is 8.5" x 11" when 
formatted with *t rof f text formatters. Page numbers appear at the bottom of each 
output page with odd page numbers appearing on the right side and even page 
numbers appearing on the left side. Page footers can optionally include the name of 
the reference page section. 

The format of the ULTRIX online reference pages is determined by the man . repro 
macro package. 

Macros 

The following describes the macros in the man . repro macro package. 

Any text argument can range from zero to six words. Quotation marks (" ") can be 
used to include blanks in words. If text is not specified, special treatment is applied 
to the next input line that has text to be printed. In this way, . I can be used to 
italicize a whole line or . SM followed by . B to make small bold letters. 

A prevailing indent distance is remembered between successive indented paragraphs, 
and is reset to a default value upon reaching a nonindented paragraph. Default units 
for indents / are ens (an en is 1 nroff character or 1/2 em space in current point 
size). 

Typeface and size are reset to default values before each paragraph, and after 
processing font and size setting macros. 

.B [ text... ] Sets text text in boldface. If no text is specified, the next text line is 
set in boldface. 

.BI wordl word! [ words... ] 

Sets wordl in boldface, wordl in an italic typeface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.BR wordl word.2 [ words... ] 

Sets wordl in boldface, word! in a roman typeface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 
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.CT character 

Prints the keyboard control character indicator < CTRL/ character > . For 
example, . CT A prints as <CTRL/ A> . 

.CW Sets text in a constant width font until another font change is 

encountered. 

.De Ends an unfilled display block (started by . Ds). Also ends automatic 

centering, if it was in effect. 

.Ds Starts an unfilled display block. Text between . Ds and . De is 

printed in a roman typeface, with 'no fill' mode (no wrapping and 
blank lines allowed) in effect. The display block is set flush left. 

.DT Restores default tabs. Default tabs are set to .5 inches, starting with 

.5i, li, ... . 

.EE Ends an example and restores basic text defaults and indents. 

.EX [ i ] Starts an example. Text between . EX and . EE is printed in a 

constant width font with 'ho fill' mode (no wrapping and blank lines 
allowed) in effect. The example is set flush left unless an indent i is 
specified. Units of / are ens. 

.G [ text... ] Sets text in a sans-serif typeface. If no text is specified, the next text 
line is set in a sans-serif typeface. 

.GL [ text... ] Sets text in a sans-serif italic typeface. If no text is specified, the next 
text line is set in a sans-serif italic typeface. 

.HB [ words... ] 

Sets the text in underline mode or in a sans-serif bold typeface, 
depending on the type of text formatter (nrof f or trof f). If the 
text formatter is of type nrof f, the next 999 input lines are formatted 
in underline mode (nrof f italic mode), or all the lines up to a font 
change are formatted in underline mode, depending on which limit is 
encountered first. If the text formatter is of type t rof f , text is set in 
a sans-serif bold typeface until a font change is encountered. Up to 
nine words can also be specified as arguments. 

.HP i Begins a paragraph with a hanging indent of i ens. 

.1 [ text... ] Sets text in an italic typeface. If no text is specified, the next text line 
is set in an italic typeface. 

.11 word Sets a temporary indent to the length of the specified word. 

.12 word Reverses one line and then sets a temporary indent to the length of the 

specified word. 

.IB wordl word! [ words... ] 

Sets wordl in an italic typeface, wordl in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" ")• 

.IP x i Sets the prevailing indent to /. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. Tag x appears in 
bold typeface. 
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.IR wordl word2 [ words... ] 

Sets wordl in an italic typeface, word.2 in a roman typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

•LP Same as the . PP macro. This macro is obsolete, but is provided for 

backwards compatibility. 

.MS reference _page section _subsection [ punctuation ] 

Sets refer ence_page immediately followed by section subsection in 
parentheses followed by optional punctuation, using fonts that 
distinguish this reference page reference from ordinary text. For 
example, manual (section). 

•NE Ends a note. Also cancels automatic centering if it was in effect. 

.NT [ headerl ] [ C ] 

.NT [ C ] [ header2 ] 

Starts a note. If no arguments are specified, the default header for the 
note is 'NOTE'. If the first argument is the letter 'C\ all text in the 
note is centered, for the next 99 text lines or until the . NE macro is 
called, whichever comes first. If the first argument is not 'C, it 
becomes the header of the note, even if headerl is also specified. The 
headerl argument becomes the header of the note if the first argument 
is 'C\ 

•PD [ v ] Sets the interparagraph distance to v vertical spaces. Resets the 

distance to the default value if v is omitted. 

.PN x [ y ] Sets x in an italic or constant width typeface (depending on the 

*rof f formatter type) and then reverts to the previous typeface. The 
optional argument y is appended to x with no space, but printed in the 
previous typeface. The x argument is usually a path name; y is usually 
punctuation. 

.Pn x y [ z ] Sets x in the current typeface, sets y in an italic or constant width 

typeface (depending on the *rof f formatter type) and appends it to x, 
and finally reverts to the previous typeface. The optional argument z is 
appended to y, but printed in the previous typeface. Spaces are 
removed between x, v, and z, unless quotation marks (" ") are used to 
enclose strings with spaces. The x argument is usually a fixed path 
name; y is usually a variable path name; and z is usually punctuation. 

•PP Starts a block paragraph. Sets the prevailing indent to .5i for nrof f 

and four picas for *trof f text formatters. 

.R Sets the text in a roman typeface until another font change is 

encountered. Also ends nrof f underline mode if it was in effect. 

.RB wordl wordl [ words... ] 

Sets wordl in a roman typeface, wordl in boldface, and then alternates 
between these two fonts for the remaining words, up to six words. 
Blanks between words are stripped unless the string is enclosed in 
quotation marks (" "). 

.RE [ k ] Returns to the fcth relative right shift indent level. (Restores the left 

margin to the position prior to the kth . RS call). Specifying k=0 is 
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equivalent to specifying k=l. If k is omitted, . RE restores the left 
margin to the most recent previous position. When £=1 or 0, the 
default . RS indent increment is restored. 

.RI wordl word2 [ words... ] 

Sets wordl in a roman typeface, wordl in an italic typeface, and then 
alternates between these two fonts for the remaining words, up to six 
words. Blanks between words are stripped unless the string is 
enclosed in quotation marks (" "). 

.RN Prints the return character indicator, < RETURN > . 

.RS [ i ] Shifts the left margin to the right (relatively) the amount of i ens. The 

. RS macro calls can be nested up to nine levels. If i is not specified 
for the first . RS call, the relative right shift increases .5 inch for 
nrof f and four picas for *trof f text formatters. Nested .RS calls 
increment the relative indent by i ens, or by .25 inch for nrof f, or by 
2 picas for *trof f text formatters. 

.SH text Creates a section header. 

.SM [ text ] Sets text to be two points smaller than the current point size. If no 
text is specified, the next text line is set in the smaller point size. 

.SS text Creates a subsection header. 

.TB [ words... ] 

Same as the . HB macro. This macro is is obsolete, but is provided for 
backwards compatibility. 

.TK nc[s][a][f][x] 

Begins a new reference page and sets the page title. Also sets up 
headers and footers for output pages, sets up all defaults and traps, and 
calls the . DT and . PD macros. The title appears as a header on all 
pages of the formatted reference page. The n argument is the reference 
page name. The c argument is the primary section number or letter. 
The s argument is the subsection, if any. The a argument is for an 
optional machine architecture specific label; for example "VAX". 
The /argument optionally alters a portion of the page footer. The x 
argument is for optional extra commentary; for example 
"Unsupported". 

Fields n, c, and s appear together at the top of each output page (see 
the top of this page for an example). These fields alternate between 
the right top and left top of a page header, corresponding to odd and 
even page numbers. Field a appears opposing the page name in the 
header when formatted with nrof f , but appears as a bleed tab when 
formatted with *trof f text formatters. The /argument appears in 
the page footer on the inside edge of the page (left for odd page 
numbers, right for even). The x argument appears underneath the page 
name in the header. 

The last three fields are optional. To skip a field, specify a pair of 
quotation marks ("") in the field to be skipped. 

.TP i Sets the prevailing indent to i. Then begins the indented paragraph 

with a hanging tag given by the next text line. If the tag does not fit, 
the macro places the next text on a separate line. 
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.UF footer Replaces the section name (adjacent to the 'chapter-page_number' pair 
in the page footer), defined by the -rpS option, with the text footer. 
This macro must not be called before the . TH macro. 

•VE End a vertical margin bar. 

.VS [ 4 ] Starts a vertical margin bar, if '4' is specified; otherwise, the macro 

does nothing. 

Macros That Cause Line Breaks 

The following macros cause line breaks: 
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Macros That Need Text Lines 

The following macros affect the following line of text if they are specified in the 
input without arguments: 
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Automatic hyphenation is turned off. 

Characters printed from the Special Font are artificially bolded by three units 
whenever the current font is '3'. 

The default page size is 80 columns by 66 lines for nrof f output and 8.5" x 11" for 
output generated by *trof f text formatters. The text area is horizontally placed on 
the page so that the effective page margin is .5 inches for nrof f and 7.5 picas for 

• t r o f f text formatters . 

The . TH macro sets up the following defaults: 

• Text is set in "noadjust" mode; the right margin is ragged. 

• The default interparagraph distance is lv for nrof f and .5v for *trof f text 
formatters. 

• The basic text indent is .5 inches for nrof f and four picas for *trof f text 
formatters, from the left margin. 

• The maximum text line length is 7 inches for nrof f and 36 picas for *trof f 
text formatters. 

• Sets tab stops every .5 inches. 

• The basic text point size is 1 1 points, with line spacing set to 12 points. 

• The basic text font is "R" (a roman typeface). 

• Reference page headers, section headers, and subsection headers are set in a 
sans-serif bold typeface. 
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Options 



-nN Numbers the first generated page as N. 

-rll Turns on line double-spacing mode. 

-rpS Sets the section number to S. The section number determines if the 

name of a section will appear in the page footer. If the value of S is 0, 
no name appears in the page footer. When S is specified, that number 
determines the name that will appear in the footer. The section 
number appears in output page footers as S-N (chapter-page-number). 
If S is not 0, the name of the section appears on the inside of the page 
footer, adjacent to the chapter-page-number sequence. 



Restrictions 



Predefined Registers 

The following registers are predefined by the man macro package and should not be 
changed: 

PO Page offset and page margin 

IN Left margin indent relative to the section headers 

LL Line length including IN 

PL Page length 

The register '1' is predefined when you specify the *rof f -rl option. Its default 
value is 0. The man(l) command does not use this option. 

The register 'p' is predefined when you specify the *rof f -rp option. Its default 
value is 0. The man(l) command does not use this option. 

The register 'p' should be set to a range 1-8 or 11-18 for unsupported reference 
pages. It cannot be set to values T, 'n', 'o', or 'p'. 

Reserved Registers 

The following registers are reserved for internal use by the man, man . nopage, and 
man . repro macro packages: 

Al DX EX 1 p p# 
PF 

In addition, registers beginning with the characters ')', ']', and ' } ' are also reserved 
for internal use. 

Registers predefined by the nrof f(l), tbl(l), commands, and the *eqn and 
*trof f text preprocessors and formatters should not be redefined. 

Predefined Strings 

The following strings are predefined by the man macro package and should not be 
changed: 

lq "if nroff, " if *troff 

rq "if nroff, "if *troff 
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S Command string to change type size to 10 points. 

Reserved Strings and Macros 

The following string and macro names are reserved for internal use by the man, 
man . nopage, and man . repro macro packages: 



## 


Al 


BD 


BK 


CD 


D 


DE 


DS 


HH 


ID 


LD 


NO 


NX 


P 


ya 


yn 


yi 


ys 



In addition, names begining with the characters ')', ']', and '}' are also reserved for 
internal use. 

Names predefined by the nrof f(l), tbl(l), commands, and the *eqn and *trof f 
text preprocessors and formatters should not be redefined. 

.TH Macro Restrictions 

The section number should only be 1-8, 'n\ T, 'o', or 'p'. Other values might not 
be recognized by the man(l) or catman(8) commands. 

Sections 6, 7, 'n', T, 'o', and 'p' do not currently have subsections, so subsections 
should not be specified. 

The architecture field (a) should not exceed four characters. A value longer than four 
characters might print outside the right page margin. 

Reference pages containing *eqn commands should be preprocessed by an *neqn 
text preprocessor before being installed on the system. 

Reference pages containing tbl(l) commands must not be preprocessed before being 
installed on the system. 

The Name Section 

The catman(8) command assumes the Name section of a reference page has the 
following format: 

name[, name, name ...] \- explanatory text 

There should be at least one space after any comma and only one space following the 
"backslash hyphen" (V). There should not be any *rof f commands in the 
explanatory text. The explanatory text should be brief. The catman(8) command 
combines information in the Name section with parameters of the . TH macro to 
create an entry in a database searched by the apropos(l), man(l), and whatis(l) 
commands. 

Portability Considerations 

The ULTRIX man macro packages contain extensions and enhancements borrowed 
from other macro packages. If you have a need to write portable reference pages, 
you should not use the following macros: 



CT 


CW 


De 


Ds 


EE 


EX 


G 


GL 


HB 


HP 


11 


12 


LP 


MS 


NE 


NT 


PN 


Pn 


R 


RN 


TB 


UF 
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The LP and TB macros are obsolete. 



The ULTRIX man . TH macro differs from other implemenations of the . TH macro. 
The primary differences are in the placement of the page title, and third and fifth 
fields in the *rof f output. The page title (the page name and section number) is 
commonly placed on both sides of the page header in other implementations. The 
more common placement of the third field is in the center of the page footer. The 
more common placement of the fifth field is in the center of the page header. 

Use of the tbl(l) and *eqn commands should be avoided, because the version of 
the man(l) command in some other implementations might not preprocess reference 
pages through the tbl(l) command. The *eqn commands also might not be 
installed. 

Examples 

The following example processes this manual page for a character-cell device: 

% cd /usr/man/man7 

% tbl man.repro.7 | nroff -rp7 -n39 -man.repro | col | lpr -Pip 

In this example, the -rp7 option for nroff initializes number register p to specify 
that this page is from Section 7 of the Reference Pages. The -n39 option specifies a 
starting page number of 39. The first page printed is numbered '7-39'. 

Files 

/usr/lib/tmac/tmac . an . repro The man . repro macro package file 

See Also 

col(l), man(l), nroff(l), tbl(l), man(7), man.nopage(7), catman(8) 
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Name 

Syntax 



me - macros for formatting papers 



nroff -me [ options ] file 
*roff-me [ options ]file 



Description 



This package of nroff and *rof f macro definitions provides a formatting facility 
for technical papers in various formats. When producing 2-column output on a 
terminal, filter the output through col(l). 

Many nroff and *rof f requests are unsafe in conjunction with this package; 
however, these requests can be used with impunity after the first .pp: 

.bp Begin new page 

.br Break output line here 

.sp n Insert n spacing lines 

.Is n Line spacing: n=l single, n=2 double space 

.na No alignment of right margin 

.ce n Center next n lines 

.ul n Underline next n lines 

.sz +n Add n to point size 

Output of the eqn, neqn, refer, and tbl preprocessors for equations and tables is 
acceptable as input. 



Requests 



In the following list, "initialization" refers to the first .pp, .lp, .ip, .np, .sh, or .uh 
macro. This list is incomplete; see the -me Reference Manual, ULTRIX 
Supplementary Documents Vol. I: General User, for further details. 



Request 


Initial Cause Explanation 
Value Break 




.(b 


yes 


Begin block. 




•(c 


yes 


Begin centered block. 




•(d 


no 


Begin delayed text. 




•(f 


no 


Begin footnote. 




.(1 


yes 


Begin list. 




•(q 


yes 


Begin major quote. 




.(x X 


no 


Begin indexed item in index. 


X 


.(z 


no 


Begin floating keep. 




•)b 


yes 


End block. 




•)c 


yes 


End centered block. 




•)d 


yes 


End delayed text. 




•)f 


yes 


End footnote. 




•)1 


yes 


End list. 




•)q 


yes 


End major quote. 




•)x 


yes 


End index item. 




.)z 


yes 


End floating keep. 
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.++ m H - no Define paper section, m defines the part of the paper, and can be C 

(chapter), A (appendix), P (preliminary; for example, an abstract, table 

of contents, and so on), B (bibliography), RC (chapters renumbered 

from page one each chapter), or RA (appendix renumbered from page 

one). 

Begin chapter (or appendix, etc., as set by .++). T is the chapter title. 

One-column format on a new page. 

Two-column format. 

Space after equation produced by eqn or neqn. 

Precede equation; break out and add space. Equation number is y. 

The optional argument x may be / to indent equation (default), L to 

left-adjust the equation, or C to center the equation. 

End table. 

End heading section of table. 

Begin table; if x is H, table has repeated heading. 

Set up for ACM style output. A is the Author's name(s), N is the total 

number of pages. Must be given before the first initialization. 

Print x in boldface; jf there is no argument, switch to boldface. 

Augments the base indent by n. This indent is used to set the indent on 

regular text (like paragraphs). 

Begin new column. 

Print x in bold italics (nofill only). 

Print x in a box (nofill only). 

Set even footer to x y z. 

Set even header to x y z. 

Set footer to x y z. 

Suppress headers and footers on next page. 

Set header to x y z. 

Draw a horizontal line. 

Italicize x; if x missing, italic text follows. 

Start indented paragraph, with hanging tag x. Indentation is y ens 

(default 5). 

Start left-blocked paragraph. 

Read in a file of local macros of the form *x. Must be given before 

initialization. 

Start numbered paragraph. 

Set odd footer to x y z. 

Set odd header to x y z. 

Print delayed text. 

Begin paragraph. First line indented. 

Roman text follows. 

Reset tabs to default values. 

Read in a file of special characters and diacritical marks. Must be 

given before initialization. 

Section head follows, font automatically bold, n is level of section, x 

is title of section. 

Leave the next page blank. Only one page is remembered ahead. 

Augment the point size by n points. 

Produce the paper in thesis format. Must be given before 

initialization, 
.tp no yes Begin title page. 
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+cT 


- 


yes 


lc 


1 


yes 


2c 


1 


yes 


EN 


- 


yes 


EQ*y 


~ 


yes 


,TE 


_ 


yes 


,TH 


- 


yes 


.TSjc 


- 


yes 


.ac A N 


- 


no 


.b x 


no 


no 


.ba +n 





yes 


.be 


no 


yes 


.bi x 


no 


no 


.bxx 


no 


no 


.ef x y z 


** s s 


no 


.eh 'x'y'z' 


"" 


no 


.fo 'x'y'z' 


"" 


no 


.hx 


- 


no 


.he 'x'y'z' 


"" 


no 


.hi 


- 


yes 


Ax 


no 


no 


.ipxy 


no 


yes 


■lp 


yes 


yes 


.10 


- 


no 


.np 


1 


yes 


.of 'x'y'z' 


//// 


no 


.oh 'x'y'z' 


"" 


no 


.pd 


- 


yes 


•PP 


no 


yes 


.r 


yes 


no 


.re 


- 


no 


.sc 


no 


no 


.sh nx 


- 


yes 


.sk 


no 


no 


.sz +n 


lOp 


no 


.th 


no 


no 



me (7) 

•u x - no Underline argument (even in *roff). (Nofill only), 

•uh - yes Like .sh, but unnumbered, 

.xp x - no Print index x. 



Files 



/usr/lib/tmac/tmac . e 
/usr/lib/me/* 



See Also 



refer(l), tbl(l), nroff(l) 

-me Reference Manual, ULTRIX Supplementary Documents, Vol. I: General User 
Writing Papers with Nroff Using -me ULTRIX Supplementary Documents Vol. I: 
General User 
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Name 



ms - text formatting macros 



Syntax 



nroff -ms [options] file 
*roff -ms [options] file 



Description 



This package of nroff and *rof f macro definitions provides a formatting facility 
for various styles of articles, theses, and books. When producing 2-column output on 
a terminal or lineprinter, or when reverse line motions are needed, filter the output 
through col(l). All external -ms macros are defined in the following section. 
Many nroff and *rof f requests are unsafe in conjunction with this package. 
However, the first four requests in the list that follows can be used with impunity 
after initialization, and the last two may be used even before initialization: 

.bp Begin new page 

.br Break output line 

.sp n Insert n spacing lines 

.ce n Center next n lines 

.Is n Line spacing: n=l single, n=2 double space 

.na No alignment of right margin 

Font and point size changes with \f and \s are also allowed; for example, \fIword\fR 
italicize word. Output of the tbl, *eqn, and ref er(l) preprocessors for equations, 
tables, and references is acceptable as input. 



Requests 



Macro 


Initial 


Brc 


Name 


Value 


Res 


.ABx 


— 


y 


.AE 


- 


y 


.AI 


— 


y 


.AM 


— 


n 


.AU 


- 


y 


.Bx 


— 


n 


.Bl 


— 


y 


.B2 


- 


y 


.BT 


date 


n 


.BXjc 


— 


n 


.CM 


ift 


n 


.CT 


- 


y.y 


.DA* 


ifn 


n 


.DE 


— 


y 


.DS-ry 


I 


y 


JDy 


8n,.5i 


y 


.LD 


— 


y 


.CD 


— 


y 


.BD 


- 


y 


.EF* 


— 


n 



Begin abstract; if x=no, do not label abstract. 

End abstract. 

Author's institution. 

Better accent mark definitions. 

Author's name. 

Embolden x ; if no x, switch to boldface. 

Begin text to be enclosed in a box. 

End boxed text and print it. 

Bottom title, printed at foot of page. 

Print word x in a box. 

Cut mark between pages. 

Chapter title: page number moved to CF (TM only). 

Force date x at bottom of page; today if no x . 

End display (unfilled text) of any kind. 

Begin display with keep; ;c=I,L,C,B; y=indent . 

Indented display with no keep; y =indent. 

Left display with no keep. 

Centered display with no keep. 

Block display; center entire block. 

Even page footer x (3 part, as for .tl). 
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.EH* 


— 


n 


.EN 


— 


y 


.EQxy 


- 


y 


.FE 


— 


n 


.FP 


— 


n 


.FSx 


— 


n 


.HD 


undef 


n 


.1* 


- 


n 


.IPxy 


- 


y.y 


.IX x y 


- 


y 


.KE 


— 


n 


.KF 


— 


n 


.KS 


— 


y 


.LG 


— 


n 


.LP 


- 


y.y 


MCx 


- 


y.y 


.NDjc 


ift 


n 


.NH;cy 


- 


y.y 


.NL 


lOp 


n 


.OF* 


- 


n 


.OH* 


— 


n 


.PI 


ifTM 


n 


.PP 


- 


y.y 


.PT 


-%- 


n 


.PX* 


- 


y 


QP 


- 


y.y 


.R 


on 


n 


.RE 


5n 


y.y 


.RPjc 


— 


n 


.RS 


5n 


y.y 


.SH 


- 


y.y 


.SM 


- 


n 


.TA 


8n,5n 


n 


.TC* 


— 


y 


.TE 


— 


y 


.TH 


- 


y 


.TL 


— 


y 


.TM 


off 


n 


.TSx 


- 


y.y 


.UL* 


- 


n 


.UXjc 


— 


n 


.XAxy 


- 


y 


.XE 


- 


y 


.XP 


- 


y.y 


.XS;cy 


- 


y 


.1C 


on 


y.y 


.2C 


- 


y.y 


•]- 


- 


n 


.[0 


- 


n 


•[N 


- 


n 



Even page header x (3 part, as for .tl). 

End displayed equation produced by *eqn. 

Break out equation; x=L,I,C; y=equation number. 

End footnote to be placed at bottom of page. 

Numbered footnote paragraph; may be redefined. 

Start footnote; x is optional footnote label. 

Optional page header below header margin. 

Italicize x ; if no x , switch to italics. 

Indented paragraph, with hanging tag x ; y =indent. 

Index words x, y and so on (up to five levels). 

End keep of any kind. 

Begin floating keep; text fills remainder of page. 

Begin keep; unit kept together on a single page. 

Larger; increase point size by 2. 

Left (block) paragraph.. 

Multiple columns; *=column width. 

No date in page footer; jc is date on cover. 

Numbered header; x=level, *=0 resets, x=S sets to y . 

Set point size back to normal. 

Odd page footer x (3 part, as for .tl). 

Odd page header x (3 part, as for .tl). 

Print header on first page. 

Paragraph with first line indented. 

Page title, printed at head of page. 

Print index (table of contents); x=no, suppresses title. 

Quote paragraph (indented and shorter). 

Return to Roman font. 

Retreat: end level of relative indentation. 

Released paper format; x =no, stops title on first page. 

Right shift: start level of relative indentation. 

Section header, in boldface. 

Smaller; decrease point size by two. 

Set tabs to 8n 16n ... (nroff) 5n lOn ... (*roff). 

Print table of contents at end; x =no, suppresses title. 

End of table processed by tbl. 

End multipage header of table. 

Title in boldface and two points larger. 

UC Berkeley thesis mode. 

Begin table; if x=H, table has multipage header. 

Underline x, even in *roff. 

UNIX; trademark message first time; x appended. 

Another index entry; x=page or no for none; y=indent. 

End index entry (or series of .IX entries). 

Paragraph with first line exdented, others indented. 

Begin index entry; *=page or no for none; y=indent. 

One-column format, on a new page. 

Begin two-column format. 

Beginning of refer reference. 

End of unclassifiable type of reference. 

N= 1 :journal-article, 2:book, 3:book-article, 4:report. 
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Registers 



Formatting distances can be controlled in -ms by means of built-in number registers. 
For example, this sets the line length to 6.5 inches: 

LL 6.5i 



.nr 



Here is a table of number registers and their default values: 
Name Register Controls Takes EffectDefault 



PS 


Point size 


paragraph 


10 


vs 


Vertical spacing 


paragraph 


12 


LL 


Line length 


paragraph 


6i 


LT 


Title length 


next page 


same as LL 


FL 


Footnote length 


next .FS 


5.5i 


PD 


Paragraph distance paragraph 


lv(ifn), .3v(ift) 


DD 


Display distance 


displays 


lv(ifn), .5v(ift) 


PI 


Paragraph indent 


paragraph 


5n 


Qi 


Quote indent 


next .QP 


5n 


FI 


Footnote indent 


next .FS 


2n 


PO 


Page offset 


next page 


0(if n), ~li (if t) 


HM 


Header margin 


next page 


li 


FM 


Footer margin 


next page 


li 


FF 


Footnote format 


next .FS 


(1, 2, 3 available) 



When resetting these values, make sure to specify the appropriate units. Setting the 
line length to 7, for example, results in output with one character per line. Setting FF 
to 1 suppresses footnote superscripting; setting it to 2 also suppresses indentation of 
the first line; and setting it to 3 produces an .IP-like footnote paragraph. 

Here is a list of string registers available in -ms; they can be used anywhere in the 
text: 



Name 

\*Q 
\*U 
\*_ 

\*(MO 

\*(DY 

\** 

\*' 

\*A 

\*, 

\*: 
\* 



String's Function 

Quote (" in nroff, ' ' in *roff ) 
Unquote (" in nroff, " in *roff) 



Dash (-- in nroff, — in *roff ) 
Month (month of the year) 
Day (current date) 
Automatically numbered footnote 
Acute accent (before letter) 
Grave accent (before letter) 
Circumflex (before letter) 
Cedilla (before letter) 
Umlaut (before letter) 
Tilde (before letter) 

When using the extended accent mark definitions available with .AM, these strings 
should come after, rather than before, the letter to be accented. 



Restrictions 



Floating keeps and regular keeps are diverted to the same space, so they cannot be 
mixed together with predictable results. 
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Files 



/usr/lib/tmac/tmac . s 
/usr/lib/ms/s.??? 



See Also 

refer(l),tbl(l) 
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Name 



term - conventional names for terminals 



Description 



Certain commands use these terminal names. They are maintained as part of the shell 
environment. For further information, see sh(l), and environ(7). 



Lear-Siegler ADM-3a 

Hewlett-Packard HP262? series terminals 

Hewlett-Packard HP264? series terminals 

Human Designed Systems Concept 100 

Heathkit H19 

Microterm mime in enhanced ACT IV mode 

Diablo 1620 (and others using HyType II) 

DASI/DTC/GSI 300 (and others using HyType I) 

Teletype Model 33 

Teletype Model 37 

Teletype Model 43 

Texas Instruments TI735 (and TI725) 

Texas Instruments TI745 

Terminals with no special features 

A terminal on a phone line with no known characteristics 

A terminal on a network connection with no known characteristics 

Tektronix 4014 

Digital Equipment Corp. VT52 

Digital Equipment Corp. VT100 

Digital Equipment Corp. VT200 

Digital Equipment Corp. VT300 



adm3a 

2621 

hp 

clOO 

hl9 

mime 

1620 

300 

33 

37 

43 

735 

745 

dumb 

dialup 

network 

4014 

vt52 

vtlOO 

vt200 

vt300 

xterm 

See /etc/termcap for an up-to-date and locally correct list. See termcap(5) for 
more information on /etc/termcap. 

Commands whose behavior may depend on the terminal, either consult TERM in the 
environment, or accept arguments of the form -Tterm, where term is one of the 
names given above. 



xterm terminal emulator, X window system 



used on VT220, VT240 
used on VT330, VT340 



See Also 



clear(l), ex(l), plot(lg), more(l), sh(l), stty(l), tabs(l), nroff(l), tset(l), ul(l), 
termcap(3x), termcap(5), environ(7) 
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Index 



article 

formatting, 7-43 
ASCII character set 

map, 7-2t 
ascii keyword, 7-2 

B 

book 

formatting, 7-43 



CSNET site 

sending mail to, 7-15 



environ global variable, 7-3 
environment 

strings, 7-3 
EXINIT string, 7-3 



formatting 

article, 7-43 
book, 7-43 
thesis, 7-43 



H 

hier keyword, 7-4, 7-9 
hierarchy 

root file system, 7-4, 7-9 
HOME string, 7-3 

I 

intro(7) keyword, 7-1 



M 

mail 

abbreviating address, 7-14 

address protocol, 7-14 to 7-15 

ARPA protocol and, 7-15 

compatible addresses, 7-14 

routing, 7-15 

uucp and, 7-14 
mailaddr keyword, 7-14 
man macro package 

macros, 7-16 to 7-20, 7-16, 7-16 to 7-23 
man.nopage macro package 

macros, 7-24 to 7-28, 7-24 to 7-31 
man.repro macro package 

macros, 7-32 to 7-36, 7-32 
manual page 

formatting, 7-16, 7-24, 7-32 
me macro package, 7-40 

requests, 7-40t 
ms macro package 

floating keep restriction, 7-45 

number registers, 7-45, 7-43 

requests, 7-43t 

string registers, 7-45 



PATH string, 7-3 
postmaster 

defined, 7-15 
PRINTER string, 7-3 



root file system 

hierarchy, 7-4 to 7-5, 7-9 

s 

SHELL string, 7-3 



technical paper 

formatting, 7-40 
term command, 7-47 
TERM string, 7-3 
TERMCAP string, 7-3 
terminal 

conventional names, 7— 47t 
thesis 

formatting, 7-43 

u 

USER string, 7-3 
/usr file system 

hierarchy, 7-5 to 7-8, 7-10 
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How to Order Additional Documentation 



Technical Support 

If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 
your electronic, telephone, or direct mail order. 



Electronic Orders 

To place an order at the Electronic Store, dial 800-234-1998 using a 1200- or 2400-baud modem from 
anywhere in the USA, Canada, or Puerto Rico. If you need assistance using the Electronic Store, call 
800-DIGITAL (800-344-4825). 



Telephone and Direct Mail Orders 



Your Location 


Call 


Contact 


Continental USA, 
Alaska, or Hawaii 


800-DIGITAL 


Digital Equipment Corporation 

P.O. Box CS2008 

Nashua, New Hampshire 03061 


Puerto Rico 


809-754-7575 


Local Digital Subsidiary 


Canada 


800-267-6215 


Digital Equipment of Canada 

Attn: DECdirect Operations KA02/2 

P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 



International 

Internal 



Local Digital subsidiary or 
approved distributor 

SSB Order Processing - WMO/E15 

or 

Software Supply Business 

Digital Equipment Corporation 

Westminster, Massachusetts 01473 



* For internal orders, you must submit an Internal Software Order Form (EN-0 1740-07). 
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ULTRIX 

Macro Packages and 
Conventions 
AA-LY19B-TE 



Please use this postage-paid form to comment on this manual. If you require a written reply to a software 
problem and are eligible to receive one under Software Performance Report (SPR) service, submit your 
comments on an SPR form. 



Thank you for your assistance. 

Please rate this manual: 

Accuracy (software works as manual says) 

Completeness (enough information) 

Clarity (easy to understand) 

Organization (structure of subject matter) 

Figures (useful) 

Examples (useful) 

Index (ability to find topic) 

Page layout (easy to find information) 

What would you like to see more/less of? 



Excellent 


Good 


Fair 


Poor 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


D 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 



What do you like best about this manual? 



What do you like least about this manual? 



Please list errors you have found in this manual: 
Page Description 



Additional comments or suggestions to improve this manual: 



What version of the software described by this manual are you using? 

Name/Title 

Company 

Mailing Address 

Email 



Dept. 



Date 



Phone 
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Reader's Comments 



Reference Pages Section 7: 



ULTRIX 

Macro Packages and 
Conventions 
AA-LY19B-TE 



Please use this postage-paid form to comment on this manual. If you require a written reply to a software 
problem and are eligible to receive one under Software Performance Report (SPR) service, submit your 
comments on an SPR form. 



Thank you for your assistance. 

Please rate this manual: 

Accuracy (software works as manual says) 

Completeness (enough information) 

Clarity (easy to understand) 

Organization (structure of subject matter) 

Figures (useful) 

Examples (useful) 

Index (ability to find topic) 

Page layout (easy to find information) 

What would you like to see more/less of? 
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What do you like best about this manual? 



What do you like least about this manual? 



Please list errors you have found in this manual: 
Page Description 



Additional comments or suggestions to improve this manual: 



What version of the software described by this manual are you using? 

Name/Title 

Company 

Mailing Address 

Email 



Dept. 



Date 



Phone 
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